<?php

/**
 * 装饰器模式（扩展系统功能）
 * 
 * 概述：动态地给一个对象增加一些额外的职责，就增加对象功能来说，装饰模式比生成子类实现更为灵活。
 * 
 * 类型：结构型模式
 * 
 * 角色：
 *  1，抽象组件。
 *  2，具体组件。
 *  3，抽象装饰器。
 *  4，具体装饰器。
 *  
 * 优点：
 *   1，对于扩展一个对象的功能，装饰模式比继承更加灵活性，不会导致类的个数急剧增加。
 *   2，可以通过一种动态的方式来扩展一个对象的功能，通过配置文件可以在运行时选择不同的具体装饰类，从而实现不同的行为。
 *   3，可以对一个对象进行多次装饰，通过使用不同的具体装饰类以及这些装饰类的排列组合，可以创造出很多不同行为的组合，
 *   得到功能更为强大的对象。
 *   4，具体构件类与具体装饰类可以独立变化，用户可以根据需要增加新的具体构件类和具体装饰类，原有类库代码无须改变，
 *   符合“开闭原则”。
 *  
 * 缺点：
 *  1，使用装饰模式进行系统设计时将产生很多小对象，这些对象的区别在于它们之间相互连接的方式有所不同，
 *  而不是它们的类或者属性值有所不同，大量小对象的产生势必会占用更多的系统资源，在一定程序上影响程序的性能。
 *  2，装饰模式提供了一种比继承更加灵活机动的解决方案，但同时也意味着比继承更加易于出错，排错也很困难，
 *  对于多次装饰的对象，调试时寻找错误可能需要逐级排查，较为繁琐。
 *  
 * 其它：
 *  透明装饰模式和半透明装饰模式
 */

/**
 * 抽象组件
 */
interface Component
{
	public function operation();
}

/**
 * 具体组件
 */
class ConcreteComponent implements Component
{
	public function operation()
	{
		echo 'Concrete Component operation <br />';
	}
}

/**
 * 抽象装饰器
 */
class Decorator implements Component
{
	protected $_component;
	
	public function __construct(Component $component)
	{
		$this->_component = $component;
	}
	
	public function operation()
	{
		$this->_component->operation();
	}
}

/**
 * 具体装饰者A
 */
class ConcreteDecoratorA extends Decorator
{
	public function operation()
	{
		parent::operation();
		$this->addedOperationA();
	}
	
	public function addedOperationA()
	{
		echo 'Add Operation A <br />';
	}
}

/**
 * 具体装饰在B
 */
class ConcreteDecoratorB extends Decorator
{
	public function operation()
	{
		parent::operation();
		$this->addedOperationB();
	}
	
	public function addedOperationB()
	{
		echo 'Add Operation B <br />';
	}
}

class Client
{
	public static function main()
	{
		$component = new ConcreteComponent();
        $decoratorA = new ConcreteDecoratorA($component);
        $decoratorB = new ConcreteDecoratorB($decoratorA);
 
        $decoratorA->operation();
        $decoratorB->operation();
	}
}

Client::main();